home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmImSetValues.z / XmImSetValues
Encoding:
Text File  |  2002-10-03  |  7.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss - An input manager function that updates
  10.           attributes of an input context
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/XmIm.h>
  14.           vvvvooooiiiidddd XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  16.           AAAArrrrggggLLLLiiiisssstttt aaaarrrrgggglllliiiisssstttt,
  17.           CCCCaaaarrrrddddiiiinnnnaaaallll aaaarrrrggggccccoooouuuunnnntttt,
  18.           );
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents Motif 2.1.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss updates attributes of the input context
  25.           associated with the specified widget. The _a_r_g_l_i_s_t argument
  26.           is a list of attribute/value pairs for the input context.
  27.           This function passes the attributes and values to
  28.           _X_I_C_S_e_t_V_a_l_u_e_s. The initial call to this routine should pass
  29.           in all of the input context attributes.  Thereafter, the
  30.           application programmer calls XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss, for an XIC, only
  31.           if a value has changed.
  32.  
  33.           If the previous parameters for the widget's XIC do not allow
  34.           the previously registered XIC to be reused, that XIC will be
  35.           unregistered, and a new one will be created and registered
  36.           with the widget. Note that sharing of data is preserved.
  37.  
  38.           Note that the Text and TextField widgets call the
  39.           XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss function when they receive focus. Therefore,
  40.           further calls to the XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss function for these
  41.           widgets are unnecessary.
  42.  
  43.           _w_i_d_g_e_t    Specifies the ID of the widget registered with the
  44.                     input manager
  45.  
  46.           _a_r_g_l_i_s_t   Specifies the list of attribute/value pairs to be
  47.                     passed to _X_I_C_S_e_t_V_a_l_u_e_s; the following attributes
  48.                     are accepted:
  49.                     _X_m_N_p_r_e_e_d_i_t_S_t_a_r_t_C_a_l_l_b_a_c_k_X_m_N_p_r_e_e_d_i_t_D_o_n_e_C_a_l_l_b_a_c_k_X_m_N_p_r_e_e_d_i_t_D_r_a_w_C_a_l_l_b_a_c_kand
  50.                     _X_m_N_p_r_e_e_d_i_t_C_a_r_e_t_C_a_l_l_b_a_c_k. These attributes accept
  51.                     an accompanying value of type pointer to structure
  52.                     of type _X_I_M_C_a_l_l_b_a_c_k.
  53.  
  54.                     These callbacks are used only when the
  55.                     _X_m_N_p_r_e_e_d_i_t_T_y_p_eresource of the relevant _V_e_n_d_o_r_S_h_e_l_l
  56.                     has the "onthespot" value, and that the XIM
  57.                     supports _X_I_M_P_r_e_e_d_i_t_C_a_l_l_b_a_c_k_s input style. These
  58.                     values are ignored if the condition is not met.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmIIIImmmmSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     For each of these callbacks, if the callback value
  75.                     is not set by this function, no action will be
  76.                     taken when the Input Method tries to call this
  77.                     callback.  Refer to the "Xlib - C Language X
  78.                     Interface, X Version 11, Release 6," Chapter 13
  79.                     for the detail of these callbacks.
  80.  
  81.           _a_r_g_c_o_u_n_t  Specifies the number of attribute/values pairs in
  82.                     the argument list (_a_r_g_l_i_s_t)
  83.  
  84.           Resources that can be set for the input context include:
  85.  
  86.           XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd
  87.                     Specifies the pixel value for the background
  88.                     color.
  89.  
  90.           XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnnddddPPPPiiiixxxxmmmmaaaapppp
  91.                     Specifies a pixmap for tiling the background.
  92.  
  93.           XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
  94.                     Specifies the font list used by the widget. The
  95.                     input method uses the first occurrence of a font
  96.                     set tagged with XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG. If no such
  97.                     instance is found, the first font set in the font
  98.                     list is used. If the font list does not contain a
  99.                     font set, a value is not passed to _X_I_C_S_e_t_V_a_l_u_e_s.
  100.  
  101.           XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd
  102.                     Specifies the pixel value for the foreground
  103.                     color.
  104.  
  105.           XXXXmmmmNNNNlllliiiinnnneeeeSSSSppppaaaacccceeee
  106.                     Specifies the line spacing used in the pre-edit
  107.                     window.
  108.  
  109.           XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee
  110.                     Specifies the render table used by the widget.
  111.  
  112.           XXXXmmmmNNNNssssppppoooottttLLLLooooccccaaaattttiiiioooonnnn
  113.                     Specifies the _x and _y coordinates of the position
  114.                     where text will be inserted in the widget handling
  115.                     input, whose input method style is """"OOOOvvvveeeerrrrTTTThhhheeeeSSSSppppooootttt"""".
  116.                     The _ycoordinate is the position of the baseline
  117.                     used by the current text line.
  118.  
  119.           The caller may also pass any other vendor-defined resources
  120.           to this function. For additional information on the
  121.           internationalization interface, see the Xlib documentation.
  122.  
  123.      RRRREEEELLLLAAAATTTTEEEEDDDD
  124.           XXXXmmmmIIIImmmmSSSSeeeettttFFFFooooccccuuuussssVVVVaaaalllluuuueeeessss(3), XXXXmmmmIIIImmmmVVVVaaaaSSSSeeeettttFFFFooooccccuuuussssVVVVaaaalllluuuueeeessss(3), and
  125.           XXXXmmmmIIIImmmmVVVVaaaaSSSSeeeettttVVVVaaaalllluuuueeeessss(3).
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.